列表框 (List Box) 节点

列表框 (List Box) 节点可用于排列可滚动列表中的项。例如，使用列表框 (List Box) 节点可以创建联系人列表、媒体播放器中的专辑列表或者汽车设置列表。布局控制节点会将自己的项排列在静态布局中，而列表框 (List Box) 节点会将自己的项排列在一个列表中，而且用户每次只能在列表中看到一定数量的项。要访问更多的项，用户需要滚动列表框。请参阅 布局控制节点。

通用列表框属性

要设置列表框中项的可见区域的大小，使用以下属性：

• 布局高度 (Layout Height) 设置网格列表框 (Grid List Box) 或3D 轨迹列表框 (Trajectory List Box 3D) 节点的可见区域高度。
• 布局宽度 (Layout Width) 设置网格列表框 (Grid List Box) 或3D 轨迹列表框 (Trajectory List Box 3D) 节点的可见区域宽度。
• 布局深度 (Layout Depth) 设置或3D 轨迹列表框 (Trajectory List Box 3D) 节点的可见区域深度。

选择一个项并定义其选择行为

您可以设置选中列表框中的哪个项，以及用户选中项时项如何反应。例如，您可以将选中的项放到列表框可见区域的中心。

• 要设置选中列表框中的哪个项，使用选定项索引 (Selected Item Index) 属性。索引从 0 开始。
• 要将列表框设为在用户选中项时该将项置于列表框区域的中心，使用选择行为 (Selection Behavior) 属性。请参阅将选定的项放到网格列表框 (Grid List Box) 中心和 使用 3D 轨迹列表框 (Trajectory List Box 3D) 节点。

定义列表框 (List Box) 节点的项

您可以定义列表框项的内容来源以及如何呈现该内容。例如，可以使用项模板来设置每个项的外观，并从数据源获取项数据。请参阅使用数据源。

• 要设置为列表框 (List Box) 节点中的项提供数据的数据对象，使用项源 (Items Source) 属性。请参阅使用列表数据对象。
• 要设置您想要列表框 (List Box) 节点用于其列表中项的预设件模板，使用项模板 (Item Template) 属性。请参阅使用列表数据对象。
• 要在列表框中的项之间共享功能，使用项容器模板 (Item Container Template) 属性。设置项容器模板 (Item Container Template) 属性后，列表框中的每个项都会继承列表框项容器 (List Box Item Container) 节点的功能。例如，项容器模板 (Item Container Template) 可以包含状态机，用于更改列表框中选中项的比例。通过这种方式，您就不需要为每个项设置功能。请参阅使用列表框项容器 (List Box Item Container) 预设件。
• 要设置您想要一次加载多少个项到工作内存，使用 保持活动状态项计数 (Keep Alive Item Count) 属性。 在 保持活动状态项计数 (Keep Alive Item Count) 属性中设置的值越小，释放用于其他任务的工作内存就越多。请注意，这样会导致您快速滚动列表框时显示在列表框中的项出现延迟。

列表框触发器

使用 列表框 (List Box) 触发器在用户与 列表框 (List Box) 节点交互时响应。例如，您可以设置用户滚动节点时的 列表框 (List Box) 节点外观。请参阅 在用户与 网格列表框 (Grid List Box) 节点交互时响应 和 在用户与 3D 轨迹列表框 (Trajectory List Box 3D) 节点交互时响应。

另请参阅

使用网格列表框 (Grid List Box) 节点

使用 3D 轨迹列表框 (Trajectory List Box 3D) 节点

使用列表框项容器 (List Box Item Container) 预设件

打开导航